home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 2 / Atari Mega Archive CD - Volume 2.iso / minix / up1510b.tgz / up1510b / src / commands / nroff / README < prev    next >
Text File  |  1990-07-21  |  2KB  |  53 lines
  1. -----------------------------------------
  2. nroff (TOS, Minix) v0.99 BETA 2/26/90 wjr
  3. -----------------------------------------
  4.  
  5. This is an improved release of a version of nroff for both Minix and the
  6. atariST. It was written under TOS and 4BSD unix but should port easily to
  7. Minix ST as well. Unfortunately I have no access to Minix (hopefully
  8. someone did test this before sending it out...ast?).
  9.  
  10. Much of this works. The things that (still) don't are all the hard things:
  11. diversions, traps, conditionals, etc. See the man pages for what is not
  12. supported (yet). Font switching, underlining, etc. are limited to reverse
  13. video on the screen, though stdout will contain underlines as "_^H" for
  14. printers.
  15.  
  16. There is a crude man package included (tmac.an) which is still not right
  17. but is better and needs diversions to become right. It should handle most
  18. common man tasks, though. It gets installed in /usr/lib/tmac under Minix
  19. unless you change the location in nroff.h. For testing, you can
  20.  
  21.     % setenv TMACDIR .
  22.     % nroff -man file
  23.  
  24. to use tmac.an (say) in the cwd.
  25.  
  26. For porting info, look in nroff.h and the makefile. The termcap library
  27. is used to get standout capabilites for doing bold and italics to the
  28. screen. Minix and BSD have termcap(3) and S5R3 has terminfo, which I
  29. believe also includes the tgetent/tgetnum/tgetflag/tgetstr functions for
  30. compatibility.
  31.  
  32. If you want to try and use nroff for printer output, the termcap library
  33. looks for TERMCAP in your environment (a file) so that you could do:
  34.  
  35.     % env TERMCAP=printfile nroff -man file
  36.  
  37. and substitute your own file with so (standout) for your printer. This
  38. assumes your system has env, but you get the idea.
  39.  
  40. The program is small enough to work under Minix. It does not have a large
  41. stack, but does store all macros and strings in a common namespace. Look
  42. in nroff.h for the size.
  43.  
  44. If you do hack away, I would appreciate you sending me the changes
  45. so I can keep this centralized.
  46.  
  47. The future holds increased capabilites, though I find it pretty useful
  48. as it is. Most man things are possible and you can do reports and resumes
  49. and such without much problem. See the example files included (ex[12].nr).
  50.  
  51. -Bill Rosenkranz
  52. rosenkra@hall.cray.com
  53.